home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / metering / locker / man200.txt < prev    next >
Text File  |  1996-07-10  |  18KB  |  432 lines
  1. ----------------------------------------------------------------------
  2.                                  LOCKER Plus v2.00 Demo 
  3.  
  4.   Thank you for Trying LOCKER Plus v2.00 for DOS & WINDOWS. Please
  5.   notify us if you encounter any problems with LOCKER. 
  6.  
  7.   You are allowed to use this DEMO of LOCKER for 30 days. After 30 days
  8.   you should either purchase LOCKER or STOP USING the DEMO.
  9.   You are allowed to give/distribute this demo to anyone ONLY IF it
  10.   is given with this documentation and is FREE.
  11.  
  12.   We are interested in what you think about LOCKER -
  13.   what additional feature you would like to see, what you don't like about it,
  14.   and what you do like about it. Depending on what feedback I
  15.   receive, additional features may be added !
  16.  
  17. ----------------------------------------------------------------------
  18. Current versions of LOCKER available
  19.  
  20. Locker v2.00 Meters both DOS & WINDOWS programs, has a windows based
  21. LOCKCON, can meter office suites, and has the ability to support add
  22. on modules for metering NT and OS/2 programs
  23.  
  24. Locker Plus v2.00 has all the features of v2.00 plus virus detection
  25. & notification, ability to set a waiting timeout from unlimited to
  26. none, an user audit trail with date-time stamp / program name / # of
  27. concurrent users at that time, improved reporting and more
  28.  
  29. Other Products:
  30.  
  31. LanSync v1.00 Software Distribution 
  32. LanSync allows you to make a distribution image of a program either by
  33. manual specification (of the files and changes needed) or via automatic 
  34. determination. It can update the clients autoexec.bat, config.sys,
  35. Windows INI, Window Registration Database, Program Manager Groups, and copy
  36. files and directories to the client pc. Distribution is via an executable
  37. which can be email to all users that require the Distribution.
  38.  
  39. LanMenu v1.00 Windows Menuing System
  40. Creates a floating window bar which contains up to 10 tab groups. Each 
  41. group can contain upto 10 icons which when pushed start up the corresponding
  42. program, pif file, etc.  
  43. Users only see the groups and the programs they are entitled to.
  44.  
  45. ----------------------------------------------------------------------
  46.  
  47. The following licenses for LOCKER are available:
  48.  
  49.    LOCKER v2.00: USD $135 / server
  50.    LOCKER Plus v2.00: USD $175 / server
  51.  
  52.    LOCKER Plus for NFS v2.00: USD $175 / server
  53.  
  54.    LanSync v1.00: USD $175 / server
  55.    LanMenu v1.00: USD $ 85 / server 
  56.  
  57.   (S/H included) for the US & CANADA
  58.   In Massachusetts please add 5% Sales Tax.
  59.  
  60.   
  61. We accept MasterCard, Visa, Company PO's (call for approval), Company Checks
  62. and Money Order
  63.    
  64. If you want more information on any product or you wish to purchase a product
  65. we can be contacted at:
  66.  
  67.                HAMPSHIRE SOFTWARE
  68.                            300 Washington Street
  69.                            Box 216
  70.                            N. Pembroke, MA 02358
  71.  
  72.                SALES: (617) 447-8606 / (800) NET-SOFT
  73.                TECH Support: (617) 447-8607
  74.                            FAX: (617) 447-0141     
  75.                            BBS: (617) 447-2271 (300-14.4 N-8-1)
  76.  
  77.                Compuserve Address: 72607, 3042
  78.                            Internet: 72607.3042@compuserve.com
  79.                      NETSOFT@aol.com
  80.  
  81.   Dealer / Reseller inquires welcomed.
  82.  
  83.  
  84. And NOW for the usual disclaimers:
  85.  
  86. NO OTHER WARRANTIES. HAMPSHIRE SOFTWARE disclaims all other warranties,
  87. either express or implied, including but not limited to implied warranties
  88. of mechantability and fitness for a particular purpose, with respect to the
  89. software, the accompanying written materials, and any accompanying hardware.
  90. This limited warranty gives you specific legal rights. You may have others,
  91. which vary from state to state.
  92.  
  93. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. In no event shall  HAMPSHIRE SOFTWARE
  94. or its suppliers be liable for any damages whatsoever caused by the use of or
  95. inability to use this HAMPSHIRE SOFTWARE product. Because some states do not
  96. allow the exclusion or limitation of liability for consequential of incidental
  97. damages, the above limitation may not apply to you.
  98.  
  99. ----------------------------------------------------------------------
  100.  
  101. Table of Contents
  102.  
  103.  
  104. Chapter 1:
  105.     1.1 What is Locker
  106.     1.2 Requirements
  107.  
  108. Chapter 2:
  109.      2.1 Upgrading
  110.     2.2 New Installation
  111.  
  112. Chapter 3:
  113.     3.1 Screen layout and commands
  114.     3.2 Installing metering on software
  115.     3.3 Changing metering limits on software
  116.     3.4 Removing metering from software
  117.     3.5 Office Suites & Groups
  118.     3.6 Metering applications which reside on local         drives
  119.  
  120. Chapter 4:
  121.     4.1 Common Mistakes & Problems
  122.     4.2 What not to do
  123.  
  124. CHAPTER 1: INTRODUCTION
  125.  
  126. 1.1 What is LOCKER
  127.  
  128. LOCKER is a program which meters software on a network. It controls the number of users that may run a DOS or WINDOWS executable (*.COM & *.EXE
  129.  
  130. LOCKER is run from a console from which you can:
  131. Add metering to a program,
  132. Change the metering limit on a program,
  133. Remove the metering from a program,
  134. Be notified of any license violation or virus detections
  135. See the active users of a program,
  136. See the number of active users for a program,
  137. See what the peak number of users was for a program,
  138. See the number of times a user had to wait to run a program
  139. See the number of times a user canceled out of waiting for a program to be available.
  140.  
  141. You should check the licensing agreement for the software that you are installing metering on, some licensing requires that you own a copy of t
  142.  
  143. LOCKER works with most DOS based networks which support DOS file sharing and locking. It has been tested with Novell's Netware, Banyan's Vines,
  144.  
  145. 1.2 Requirements
  146.  
  147. LOCKER requires DOS 3.3 or higher and Windows 3.1, while it may work with older versions of DOS, we cannot guarantee that it will. LOCKER adds 
  148.  
  149.  
  150. CHAPTER 2: INSTALLATION
  151.  
  152. 2.0 What you need to remember after installing metering
  153.  
  154. DO NOT erase any hidden files which reside in the applications directory after installing metering. Locker uses these files and if they are rem
  155.  
  156. DO NOT erase the LOCKCON files before removing metering on all metered applications. The applications will still be metered after LOCKCON is re
  157.  
  158. 2.1 Upgrading
  159.  
  160. You should remove metering from all programs you are currently metering. Then proceed with the normal install except you should copy the LOCKER
  161.  
  162. 2.2 New Installation
  163.  
  164. This installation assumes some knowledge of DOS. If you have problems with the commands, please look them up in your DOS manual.
  165.  
  166. First copy the LOCKER disk to a drive\directory where only the SUPERVISOR or NETWORK ADMINISTRATOR has access. For example:
  167.   Copy A:*.* F:\SYSTEM\*.*
  168.  
  169.  
  170. Now startup windows
  171.  
  172. Open up the group you wish to add the LOCKER management console to (LOCKCON) and then select File/New the Program Manager window. Then press OK
  173.  
  174. Example:
  175. {EMBED MSDraw   \* mergeformat|}
  176.  
  177. Next startup the LOCKCON Program by double clicking on its it.
  178.  
  179. After starting LOCKCON (for the first time) you will see the following screen:
  180.  
  181. {EMBED MSDraw   \* mergeformat|}
  182.  
  183. For the log file drive\path you should enter a directory (it does not need to currently exist) where all your users will have full access to. F
  184.  
  185. Please Note: That for all paths that are entered via LOCKCON you should use the standard DOS paths not network specific paths (for example: do 
  186.  
  187. You have now installed LOCKER and are ready to start metering you applications.
  188.  
  189.  
  190. CHAPTER 3. USING LOCKER
  191.  
  192. 3.1 Screen Layout and commands
  193.  
  194. To run LOCKCON double click on its icon. This will bring up Locker's console:
  195.  
  196.  
  197. For each program being metered you will see the following information:
  198.  
  199. PROGRAM:     Either the program executable file name or the             description
  200.  
  201. TYPE:        Whether a program is a DOS or WINDOWS                 (DOS/WIN) based
  202.  
  203. LIMIT:    How many users can use the program concurrently
  204.  
  205. CURRENT:     How many users are currently using the program
  206.  
  207. OVER:    How many times the license was violated
  208.  
  209. PEAK USED: Peak number of concurrent users 
  210.  
  211. WAITS:     Number of users who had to wait to access the program
  212.  
  213. CANCELS:     Number of users who canceled out of waiting for             the program to be     available
  214.  
  215. TOTAL ACCESS: Number of times the program has been run
  216.  
  217. From LOCKCON  you can  either install metering on software, change the metering limits or remove metering from software.
  218.  
  219.  
  220. Actions you can do from this screen:
  221.  
  222. To install metering on a software product press Install Metering Button
  223.  
  224. To highlight a displayed software product use the arrow keys or single click on the item
  225.  
  226. To change the metering limit, first highlight the software name and then press the Edit Metering Button or double click on the item
  227.  
  228. To remove metering from a software product, first highlight the software name and then press the Remove Item Button
  229.  
  230. To add a Office Suite / Group push the Install Suite Button
  231.  
  232. To see the current users for a program, press the Users Button
  233. (The DOS Environment variable  you are using to get the ID from 
  234. must first be specified in File/SetConfig
  235.  
  236. To edit the metering limit of a suite or add/remove items in it, double click on the suite or highlight and press the Edit Metering Button
  237.  
  238. To clear the log information select Edit/Clear Log from the menu
  239.  
  240. To Clear all the logs select Edit/Clear all Logs from the menu
  241.  
  242. To print a report of the metered items select File/Print Log Info from the menu
  243.  
  244. To export the information in Locker to a comma delimited file select File/Export Log Info from the menu
  245.  
  246. To print  the audit log for a program, first highlight the program and then select File/Print Usage Report
  247.  
  248. To display the audit log for a program, first highlight the program and then select File/Display Usage Report
  249.  
  250. To print a statistical/graphical report for a program, first highlight the program and then select File/Print License Report
  251.  
  252. To display a statistical/graphical report for a program, first highlight and then select File/Display License Report
  253.  
  254. To set the DOS environment variable from which the UserID is gotten select File/SetConfig
  255.  
  256. To  force the screen to update the log information select Edit/Update (or F3)
  257.  
  258. To toggle whether the screen is updated, select Edit/Update Toggle (or F2)
  259.  
  260. To exit from LOCKCON select File/Exit from the menu
  261.  
  262. 3.2 Install metering on software
  263.  
  264. After pressing the Install Metering Button an entry screen will be displayed:
  265.  
  266.  
  267. Program : This is the software executable name (for example:     TEST.EXE - do not include that program path).
  268.  
  269. Program Desc: This is a description of the item being metered
  270.  
  271. Program Path:    Enter either the directory or the drive:\directory of     where the software is located. Please note that you should     have the same 
  272.  
  273. Module name:     Leave it blank unless the main program     actually starts another module/program and then     terminates. (Only used for windows progr
  274.  
  275. Type:    What type of program you are metering. Normally either     Windows or DOS  program).
  276.  
  277. Limit:    The maximum number of concurrent users             allowed.
  278.  
  279. Scan Time:    Enter how often you want the program to check to     see if a license is available. 
  280.  
  281. Timeout: How long can a user wait for a program to be     available. 0 = No waiting allowed, Blank = Unlimited     waiting. 
  282.  
  283. Log:    This field controls whether the extended log information     is kept.
  284.  
  285. Virus Detection: This field controls whether Locker will check     to see if a virus has infected the exe (only will find     viruses after  which in
  286.  
  287. Allow Violations: Allow Violations to occurs but keep track of     the total number of violations
  288.  
  289. After you are finished entering the information, you can either escape from adding metering by press CANCEL or install metering by press SAVE.
  290.  
  291. 3.3 Changing metering limits on software
  292.  
  293. After highlighting the software you wish to change the metering on and pressing Edit Metering Button the same screen as when you installed the 
  294.  
  295. 3.4 Removing metering from software
  296.  
  297. After highlighting the software you wish to remove the metering from and pressing the Remove Metering Button you will be prompted as to whether
  298.  
  299. 3.5  Office Suites / Groups
  300.  
  301. Before you can meter any programs in a Office Suite you must first install the basic suite information. This is done by pressing the Install Su
  302.  
  303. Suite/Group Desc This is a description of the Office Suite
  304.  
  305. Limit:    The maximum number of concurrent users             allowed for the suite.
  306.  
  307. Scan Time: Enter how often you want the program to check to     see if a license is available. 
  308.  
  309. Timeout: How long can a user wait for a program to be     available. 0 = No waiting allowed, Blank = Unlimited     waiting. 
  310.  
  311. Virus Detection: This field controls whether Locker will check     to see if a virus has infected the exe (only will find     viruses after  which in
  312.  
  313. Allow Violations: Allow Violations to occurs but keep track of     the total number of violations
  314.  
  315.  
  316. Log: This field controls whether the extended log information      is kept.
  317.  
  318. Press SAVE to save the information or CANCEL to exit with adding an office suite.
  319.  
  320. After adding a Suite there will now be an item the type GRP in the LOCKCON screen. To add/remove metering to programs in this suite or change t
  321.  
  322. This will bring up the Edit Suite Dialog Box:
  323.  
  324.  
  325. To change the user limit, enter the new limit and press SAVE.
  326.  
  327. To add metering to a program in the suite Press the Install Metering Button.
  328.  
  329. To remove metering from a program in the suite press the remove metering button.
  330.  
  331. 3.6 Metering applications on Local hard drives
  332.  
  333. There are two way of metering applications residing on local hard drives
  334.  
  335. 1) You can either install the application on the network,  install metering, and then copy all the files to the each local hard drive (Make cer
  336.  
  337. 2) Install the application on the local drive, copy the executable file to its own directory on the network, install metering on the executable
  338.  
  339. After changing the metering limits for applications residing on local drives you DO NOT have to redistribute the network files.
  340.  
  341. After removing metering from an application residing on a local drive you must either erase all copies of the application which reside on the l
  342.  
  343. Chapter 4: ERROR MESSAGES
  344.  
  345. 4.1  Common Mistakes & Problems
  346.  
  347. Most of the problems will be covered by the messages below. Since LOCKER does run on a wide variety of networks, you might get a problem which 
  348.  
  349. If you are using Norton's Desktop for Windows you will need to make the <filename>.@@@  file unhidden.
  350.  
  351. ex. Attrib TEST.@@@ -H
  352.  
  353. For  WORD PERFECT v5.1 for windows, you need to copy the WPWINFIL.EXE file in the WordPerfect directory to WPWINFIL.@@@ before installing meter
  354.  
  355. ex. copy F:\wp51\wpwinfil.exe f:\wp51\wpwinfil.@@@
  356.  
  357. For WORD PERFECT v6.0a for windows,  you need to copy the WPWIN60.EXE file in the WordPerfect directory to WPWIN60.@@@ before installing meteri
  358. program name: WPWIN.EXE and for the module name: WPWIN60.@@@
  359.  
  360. If you are moving all files from one File Server to another, make certain you unhide all files in the LOCKER log directory and each program dir
  361.  
  362.  
  363.  
  364.  
  365.     The supervisor can run a metered program but the users can not.  You have not granted rights to the log file path directory. (This is the dire
  366.  
  367.     Metering was installed but the program still allows everyone to access it. The program probably starts another program and then exits. You sho
  368.  
  369.     You are having difficulty metering windows. You should install metering on progman.exe (its a windows program) instead of win.com or win.exe.
  370.  
  371. LOCKCON Error Messages:
  372.  
  373. ERROR-001    : Error renaming the unmetered program - it may be in use by someone. Check to see if anyone is running it  and have then quit the pr
  374.  
  375. ERROR-002    : Unable to open the Locker metering stub. Check to see if you have a LOCKER.WIN or LOCKER.DOS file in the LOCKER directory. 
  376.  
  377. ERROR-003    : Unable to create an metered program stub
  378.  
  379. ERROR-004    : An error occurred during the copying of the program stub.
  380.  
  381. ERROR-005    :  Locker was unable to create the extended log information file in the log file directory
  382.  
  383. ERROR-006    : Locker was unable to open LOCKER.LOG file in the Locker directory
  384.  
  385. ERROR-007    : An error occurred while copying the LOCKER.LOG file to the extended log file in the log file directory
  386.  
  387. ERROR-008    : Locker was unable to create the metering control file in the log file directory
  388.  
  389. ERROR-009    : Locker was unable to open the LOCKER.MET file in the Locker Directory
  390.  
  391. ERROR-010    : An error occurred while copying the LOCKER.MET file
  392.  
  393. ERROR-013    : Locker was unable to create in the log file directory the metering information for the program
  394.  
  395. ERROR-014    : An error occurred during the writing the metering information file
  396.  
  397.  
  398. ERROR-011    : Locker was unable to create a file with the extension of .~LK in the program directory.
  399.  
  400. ERROR-012    : An error occurred while writing to the .~LK file
  401.  
  402. ERROR-014    :  Was not able to find the program to remove metering from. Check to see if the path originally specified for the program is still v
  403.  
  404. ERROR-15    :  It looks like the metering for this program is no longer valid. Check to see if you have a file in the programs directory with the 
  405.  
  406. ERROR-16    : Locker was unable to delete the metered program to restore it with the unmetered version
  407.  
  408. ERROR-17    : Locker was unable to rename the unmetered version back to the original name
  409.  
  410. ERROR-021     : Locker was unable to open the metering information file. (.@DT)
  411.  
  412. ERROR-022    : An error occurred while reading from the metering information file
  413.  
  414. ERROR-023    : A seek error occurred with the metering information file
  415.  
  416. ERROR-024    : An error occurred while writing to the metering information file
  417.  
  418. ERROR-041    : Locker was unable to create the LOCKER.CFG file in the locker directory
  419.  
  420. ERROR-042    : An error occurred while writing to the LOCKER.CFG file
  421.  
  422.  
  423. ERROR-050    : Locker was unable to create a file indicating that the program was a member of a suite
  424.  
  425. ERROR-051    : An error occurred during the writing to the suite location file
  426.  
  427. 4.2  What not to do:
  428.  
  429.     DO NOT erase any hidden files which reside in the applications directory after installing metering. Locker uses these files and if they are re
  430.  
  431.     DO NOT erase the LOCKCON files before removing metering on all metered applications. The applications will still be metered after LOCKCON is r
  432.